mcv
 Help information about: Views
 ^Editing
 
              E╔════════════════════════════════════════════════╗
              E║                     CViewsE                      ║
              E╚════════════════════════════════════════════════╝


 ZmccB  If you have not already read the help text dealing with CJ Classes CB, you
   should do so before reading this material on Views.

 CWhat Are Views?

   While it is often convenient to focus on a small set of objects by
   selecting a CClassB, that is sometimes too narrow a focus.  InContext
   allows you to define CViewsB, each of which consists of a group of
   object classes.  By selecting a view, you focus on one or more classes.

   For example, a "document" view might include objects of the "doc", "txt",
   and "ltr" classes, if those happen to be your class names for "document",
   "text", and "letter".  A "graphic" view might include pictures in several
   different image formats, such as "img", "pcx", etc.

   This can be helpful for a couple of reasons:

        CB You may remember that you're looking for, say, a document, but
          not remember exactly what type it is.  By selecting the "document"
          view, you can focus quickly on the set of objects most likely to
          include the one you're looking for.

        CB Just as it is possible to invoke some programs on all objects
          in a single class, it is sometimes appropriate to invoke a program
          on all objects in a view.  For example, a programmer using C and
          assembler might define a "program", or "source" view as including
          the classes "c", "h", "asm", and "mk".  By invoking a text editor
          (such as Brief) on this view, he could edit all the source modules
          in a software package in one editor session, moving among them at
          will.

   Selection of views operates in the same fashion as selecting Classes.  You
   can select a view from the EViewsB section of the main display or by
   invoking the F VDiews B command from the command bar.  Doing the latter
   results in a display such as the following.

                E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
                E█A                                          A  E█
                E█A  B E│B                                    E│B A  E█
                E█A  B E│B  EViewsB  EClassB   EObjectsB   EActionsB  E│B A  E█
                E█A  B E│B ALL      CALLB     edit.c   view-all E│B A  E█
                E█A  B E│B archive  asm     test.c   editYB-all E│B A  E█
                E█A  B E│B chess    c    hrredit.h   del-all  E│B A  E█
                E█A  B E│B document h    hrredit.mk  arc-all  E│B A  E█
                E█A  B E│B execable mk                        E│B A  E█
                E█A  B E│B finance                            E│B A  E█
                E█A  B E│B fonts                              E│B A  E█
                E█A  B E│B graphic                            E│B A  E█
                E█A  B E│B incontxt                           E│B A  E█
                E█A  B E│B letters                            E│B A  E█
                E█A  B E│B messages                           E│B A  E█
                E█A  B E│B Csource  B                           E│B A  E█
                E█A  B E│B tapcis                             E│B A  E█
                E█A  B E│B ventura                            E│B A  E█
                E█A  B E│B xref                               E│B A  E█
                E█A                                          A  E█
                E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

   As you can see, the "source " view has been selected.  The EClassB list
   shows how this view is defined.  It includes the classes "asm", "c", "h",
   and "mk".  You can also see that there are no objects of class "asm" in
   this directory, but there are examples of the other three.  This user has
   an editor that allows multiple-file editing, and has therefore defined an
   "edit-all" action applicable to whole views and classes.  If the action
   "edit-all" is selected, the user's editor will be invoked on the four
   objects in the current view.
mcve
 Help information about: Editing the Views Display
 
 
              E╔════════════════════════════════════════════════╗
              E║           CEditing the Views DisplayE            ║
              E╚════════════════════════════════════════════════╝


   The CViewsB capability is only really useful if you can define your own
   views.  To do so, you need to "Edit" the Views display.  Start by
   selecting the F VDiews B command, which will produce a display like the
   following.

        E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
        E█A                                                          A  E█
        E█A  Cxt Artifacts -- incontxt                           B1/29/A  E█
        E█A  Eiew:B CALL     B  EClass:B ChlpB   EObject:B C            B   ETask:A  E█
        E█A  C       G  View  C                                         A  E█
        E█A  B   G                                FªEDdYDit     FªHDelpG  B    A  E█
        E█A  Eour│B                                               E│A  B ESA  E█
        E█A  E ..│B EBrief NameB     EYour DescriptionB               E│A  B  A  E█
        E█A  E ..│B  CALL     B     CAll object classes            B  E│At B  A  E█
        E█A  E ..│B  archive      Archive files                   E│A  B  A  E█
        E█A  E ..│B  chess        Chess games                     E│A  B  A  E█
        E█A  E ..│B  document     Document preparation view       E│A  B  A  E█
        E█A  E ..│B  execable     Executable programs             E│A  B  A  E█
        E█A                                                          A  E█
        E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

   This display shows you what views are available, by name and description.
   If you want to add, change, or delete a view definition, simply select
   the F EDdit B command, as shown above.  The display will change to
   indicate that the name and description fields are editable, as shown
   below.

        E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
        E█A                                                          A  E█
        E█A  Cxt Artifacts -- incontxt                           B1/29/A  E█
        E█A  Eiew:B CALL     B  EClass:B ChlpB   EObject:B C            B   ETask:A  E█
        E█A  C       G  View  C                                         A  E█
        E█A  B   G  Editing View Definitions                FªHDelpG  B    A  E█
        E█A  Eour│B                                               E│A  B ESA  E█
        E█A  E ..│B EBrief NameB     EYour DescriptionB               E│A  B  A  E█
        E█A  E ..│B  IALL     B     IAll object classes            B  E│At B  A  E█
        E█A  E ..│B  Iarchive B     IArchive files                 B  E│A  B  A  E█
        E█A  E ..│B  Ichess   B     IChess games                   B  E│A  B  A  E█
        E█A  E ..│B  IdocYIumentB     IDocument preparation view     B  E│A  B  A  E█
        E█A  E ..│B  IexecableB     IExecutable programs           B  E│A  B  A  E█
        E█A  Ep..│B  Ifinance B     IFinancial management view     B  E│Ag B  A  E█
        E█A  E ..│B  Ifonts   B     ILaser printer fonts           B  E│A  B  A  E█
        E█A  C E..│B  Igraphic B     IGraphical objects             B  E│A  B  A  E█
        E█A  E CwwE│B  IincontxtB     IInContext control artifacts   B  E│A  B  A  E█
        E█A  E CwwE│B  Iletters B     ILetters on various letterhead B  E│Al B  A  E█
        E█A  E C..E│B  ImessagesB     ICompuServe messages           B  E│A  B  A  E█
        E█A  E C..E│B  Iprogram B     ISource programming view       B  E│Al B  A  E█
        E█A  E C..E│B  Isystem  B     INon-executable system files   B  E│Ae B  A  E█
        E█A  E C..E│B  Itapcis  B     ICIS- and TAPCIS-related stuff B  E│A  B  A  E█
        E█A  E C..E│B  Iventura B     IVentura Publisher artifacts   B  E│A  B  A  E█
        E█A  E CnnE│B  Ixref    B     ICross-references, maps, etc.  B  E│Ad B  A  E█
        E█A  E C..E└───────────────────────────────────────────────┘A  B  A  E█
        E█A  Eudy RAamsey ──────────────────── Mode: Work ──────── DiEskA  E█
        E█A                                                          A  E█
        E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

   The fields displayed like this: IdocumentB are editable fields.  This
   means that you can place the cursor in them and insert, delete, or replace
   characters at will.  You may be able to do this without further help, if
   you are an experienced computer user.  If you need more information about
 ZmeB  using the editing features of InContext, see CJ Editing in InContext CB.

   Each view has a "Brief Name", a "Description", and a "definition".  You
   can see the first and second of these in the display above, but the third
   is hidden.  To see (and edit) the view definition, you need to place the
   cursor on the line whose definition you want (e.g., "IdocumentB" above),
   and press either function key CF2B (the "edit" key) or the Cleft mouse
   CbuttonB.

   For example, the figure below shows a possible definition of the "document"
   view.  It indicates that the "document" view includes all objects of the
   "doc", "fmt", "lab", "ltr", "ris", and "txt" classes.  If you choose to
   have a "document" view, you will almost certainly want a different set of
   classes included.  By editing the definition to include your own list of
   classes, you define the view.  

              E▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
              E█A                                              A  E█
              E█A  B EDrive:B CcB   EView:B CALL     B  EClass:B ChlpB   EObjA  E█
              E█A  H Space  Time  Plans G  View  HClass  Object  AA  E█
              E█A  E│B               G  Editing View Definitions  A  E█
              E█A  G  Editing Definition of "document"          A  E█
              E█A  E│YBdocE                                        A  E█
              E█A  E│BfmtE                                        A  E█
              E█A  E│BlabE                                        A  E█
              E█A  E│BltrE                                        A  E█
              E█A  E│BrisE                                        A  E█
              E█A  E│BtxtE                                        A  E█
              E█A  E│B   E                                        A  E█
              E█A                                              A  E█
              E▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

   View definitions are editing using the ordinary InContext text editor.
   You should make sure that each class is named on a separate line, and
   that you include only the 1-3 character class name on the line.
